home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / list565.arc / LIST565.DOC < prev    next >
Text File  |  1986-01-16  |  11KB  |  261 lines
  1.                                                         LIST     Page 1
  2.  
  3.                         LIST Version 5.65
  4.                 (c) Copyright Vernon D. Buerg 1986
  5.  
  6.  
  7.  Command  LIST
  8.  -------------
  9.  
  10.  Purpose:  To display the contents of an ASCII text file,  line by  line
  11.            with the aid of scrolling and positioning commands.
  12.  
  13.  Format:   LIST  [d:][path]filename[.ext]
  14.  
  15.  Remarks:  An ASCII file of any size may be listed.
  16.  
  17.            The "filename" is optional.  If omitted, you are prompted  to
  18.         to enter  a filename.   You may  include drive,  path, and  wild
  19.         cards in the file name.   The first file which matches  the name
  20.         is displayed until an end-of-file character is encountered. Each
  21.         file which matches the "filename" may be displayed.
  22.  
  23.            LIST was  designed to  display ASCII  files.  That  is, files
  24.         which  contain  text  and  not  binary  or  control codes.  Text
  25.         characters usually range from a value of 32 to 127.
  26.  
  27.            Characters  below  32  (a  blank)  are  replaced with a funny
  28.         character to indicate that a non-displayable character has  been
  29.         encountered.  This character is an upside-down question mark.
  30.  
  31.            Characters above 127 may be valid graphic characters, and may
  32.         be displayed if  the '8' command  is in effect.   To insure that
  33.         characters above ASCII value 127 are not displayed, use the  '7'
  34.         command.
  35.  
  36. |          The top line of the display gives the file name, current right
  37. |       scroll offset, and the file's creation date and time. Optionally,
  38. |       a ruler may be displayed on the top line by using the alt-R keys.
  39.  
  40.            The  file  is  displayed  with  one  logical  record  on each
  41.         80-column display line.   A logical record  ends in a  linefeed.
  42.         The maximum logical record may  be 255 characters long.  If  the
  43.         record exceeds 80  characters, you may  view the portion  beyond
  44.         the 80 columns  by using the  scroll right command,  or by using
  45.         the Wrap feature.
  46.  
  47.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  48.         longer than 80 characters.  With Wrap on, lines are displayed in
  49.         their  entirety,  80  characters  per  display line.  The scroll
  50.         -left and -right functions are disabled when Wrap is ON.
  51.  
  52.            The file may  be PRINTed as  it it displayed.   The P command
  53.         toggles  the  printer  on  or  off.   When  first entered, the P
  54.         command causes the current screen  to be printed.  As new  lines
  55.         are displayed, they too are printed.  Printing may be stopped by
  56.         entering another P command.  The PrtSc key may also be used, but
  57.         the title and prompt lines will be printed with the lines of the
  58.         file. Empty lines cause a line to be skipped on the printer.
  59.                                                         LIST     Page 2
  60.  Key functions and Commands
  61.  --------------------------
  62.  
  63.         On the COMMAND line, enter a letter or control key:
  64.  
  65.         Letter(s)     Default   Function
  66.         ---------     -------   ------------------------
  67.         A                       find next occurance of 'text'
  68.         B                       skip to end of file (bottom)
  69.         D or +                  scroll down one page
  70.         F                       Find 'text' regardless of case
  71.         H or ?                  list commands (HELP)
  72.         K               off     toggle keyboard flush
  73.         L                       scroll left 20 columns
  74. |       M                       toggle test for display retrace
  75.         N                       down one (next) line
  76.         P               off     toggle printer on or off
  77.         Q                       display next matching file
  78.         R                       scroll right 20 columns
  79.         S                       Scan for exact text match
  80.         T                       restart from first block (top)
  81.         U or -                  scroll up one page
  82.         W               off     toggle wrap of lines over 80 chars
  83.         X                       terminate, clear screen and exit to DOS
  84.         7               off     turn off high bit (non-graphics only)
  85.         8               on      leave high bit on (graphics)
  86.  
  87.         \text                   Find 'text' regardless of case
  88.         /text                   Scan for exact text match
  89.  
  90.     Control key      Function
  91.     -----------     -------------------------------------------
  92.      Enter           continue to next page
  93.      END             position to end of block
  94.      ESCape          Display next matching file
  95.      HOME            restart from first block (top)
  96.      PgUp            scroll up one page
  97.      PgDn            scroll down one page
  98.  
  99.      left arrow      scroll left 20 columns
  100.      right arrow     scroll right 20 columns
  101.      up arrow        up one (previous) line
  102.      down arrow      down one (next) line
  103.  
  104.      ctl-HOME        restart from CURRENT (64k) block
  105.      ctl-PgUp        restart from first block (TOP)
  106.      ctl-PgDn        skip to end of file (BOTTOM)
  107.      ctl-left-arrow  reset scroll to column 1
  108.  
  109.      F1              Help - display summary of commands
  110.      F3              Find next occurrance of text
  111.      F10             Exit to DOS
  112.  
  113.      F5              change background color for main body of display
  114.      F6              change foreground color for main body of display
  115.      F7              change background color for top and bottom lines
  116.      F8              change foreground color for top and bottom lines
  117.  
  118.      alt-C           clone LIST.COM, change colors permanently in program file
  119. |    alt-R           toggles display of a ruler on the top line
  120.                                                         LIST     Page 3
  121.  
  122.  Screen attributes
  123.  -----------------
  124.  
  125.            The colors used for displaying the titles and main body of
  126.         text may be changed temporarily or permanently. To make a
  127.         permanent change, the cloning command alt-C is used. It requires
  128.         that the LIST.COM program file be on the current drive and in
  129.         the current directory.
  130.  
  131.            There are three classes  of attributes used.  One  for normal
  132.         display lines  - lines  2 to  24 -  another for  special lines -
  133.         lines 1 and 25, and a third for the Find/Scan color.  The border
  134.         is not changed.  The foreground color applies to the characters
  135.         displayed.
  136.  
  137.         These color attributes may be changed by using these function keys:
  138.  
  139.           For the main body of text
  140.             F5 - background color
  141.             F6 - foreground color
  142.  
  143.           For the top and bottom lines
  144.             F7 - background color
  145.             F8 - foreground color
  146.  
  147.  
  148.         Once you have decided upon the colors, use the alt-C key
  149.         combination to change the LIST.COM program file.
  150.  
  151.                                                         LIST     Page 4
  152.  
  153.  Scanning for text
  154.  -----------------
  155.  
  156.  
  157.            You may use  Find (\)  to search for text  regardless  of the
  158.         case, or you may use Scan (/) to find an exact match.
  159.  
  160.            To scan for a character string, type a slash (/) followed  by
  161.         one or more (up to 32)  characters.  The scan text, but not  the
  162.         slash,  is  displayed  on  the  command  line.  The scan is case
  163.         sensitive.  That is, lower case scan text will only match  lower
  164.         lower case file text.
  165.  
  166.            While  the  program  is  searching  for  the text, the bottom
  167.         display line is changed to say "Scanning".
  168.  
  169.            If the text is found, the line containing it is displayed  as
  170.         a high-intensity line.
  171.  
  172.            If the text is NOT found, the bottom line (25) is changed  to
  173.         say '*** text not found ***', and the display remains unchanged.
  174.  
  175.            To find the next occurrance of the same text,  use the A)gain
  176.         command, or press the F3 key.
  177.  
  178.                                                         LIST     Page 5
  179.  
  180. Update history
  181. ==============
  182.  
  183.         Lines beginning with | denote changes to the latest version.
  184.  
  185.         Version 4.1, April 27, 1984.
  186.         Version 4.15, June 2, 1984.
  187.         Version 4.2, July 14, 1984.
  188.         Version 5.0, August 10, 1984.
  189.         Version 5.1, August 27, 1984.
  190.         Version 5.2, September 29, 1984.
  191.         Version 5.4, March 22, 1984.
  192.         Version 5.48, May 27, 1985.
  193.  
  194.         Version 5.49, May 31, 1985.
  195.             Corrects ctrl-PgDn, adds file date/time display
  196.             Wrap forces Left column and Top of file
  197.  
  198.         Version 5.52, July 15, 1985.
  199.             Correct Print command problems
  200.             Adds alt-C to clone LIST.COM with new colors
  201.             The X command now clears the screen when exiting to DOS,
  202.             while F10 leaves the last display on the screen.
  203.  
  204.         Version 5.56, December 20, 1985.
  205.             Adds alt-R to toggle a ruler on the top line.
  206.             Make LIST compatible with DESQview and TopView.
  207.  
  208.         Version 5.64, January 6, 1986
  209.             Add suport for 40 (and other?) column displays
  210.             Add M command to toggle test for display retrace
  211. |           Include LISTxxxS.COM without HELP as a smaller version
  212.  
  213. |       Version 5.65, January 16, 1986
  214. |           Corrections for consecutive line feeds without CRs
  215. |           Corrections for Down at end of file
  216.                                                         LIST     Page 6
  217.  
  218.  Restrictions
  219.  ------------
  220.  
  221.            Some positioning is relative to the current block in storage.
  222.         The size of the block depends on the amount of memory available,
  223.         and up to 64K-bytes is allocated to the file buffer. The program
  224.         requires at least 6K bytes.
  225.  
  226.         o  PC-DOS Version 2.0 or later is required.
  227.  
  228.         o  ANSI.SYS is NOT required.
  229.  
  230.  
  231.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 or
  232.         later, including DOS 3.1.
  233.  
  234.         LIST is supplied for personal, private use. Feel free to
  235.         distribute LIST given these restrictions:
  236.  
  237.           o  the program shall be supplied in its original,
  238.              unmodified form, which includes this documentation;
  239.  
  240.           o  no fee is charged.
  241.  
  242.           o  commmercial use is prohibited.
  243.  
  244.           o  the program may not be included - or bundled - with
  245.              other goods or services. Exceptions may be granted
  246.              upon written request only.
  247.  
  248.         If you are using LIST and find it of value, your gift in
  249.         any amount ($15 suggested) will be greatly appreciated.
  250.  
  251.         For use by corporations and other institutions, please
  252.         contact AAI Systems for a site licensing agreement.
  253.  
  254.                 Vernon D. Buerg
  255.                 AAI Systems, Inc.
  256.                 456 Lakeshire Drive
  257.                 Daly City, CA 94015
  258.                 Data: (415) 994-2944 (RBBS)
  259.                 Compuserve: 70007,1212
  260.  
  261.